Welcome to Pete Exline's FFI DoS Editor!  Much credit to Jeff Ludwig, kea, nic0lette, Rabite and Maeson for extensive information, assistance and testing.

Version 2.7d -- improved support for non-US/English character map / keyboard users; the program should run properly in more countries now.  Many thanks to a user from
中华迫真共和国 for his help in troubleshooting.

Version 2.7c -- added Encounter Rate Tables (global) -- chance of encounter by step for 16 steps.  Updated reference files (Thanks rabite!)

Version 2.7b -- added Encounter Rates for Dungeons (not overworld yet); fixed Gil in chest > 65535

Version 2.6d error fix -- garbled spell descriptions for blank entries repaired; thanks to Maeson for troubleshooting assistance!

Version 2.6c error fix -- Master/Monk and Thief/Ninja listings were accidentally swapped for guaranteed level-up stats.  Thanks rabite!

Version 2.6 changes -- added Weapons image/animation editor as well as Monster image editor.  The definition of the 3 columns in each is a bit hazy and bears experimentation.

Version 2.4 changes -- added Spiked Tile editor.  You can't change the # per floor, but you can change the encounters and move their locations.

Version 2.3 changes -- split output files into ~9 parts for easier cross-editing; rearranged columns based on Rabite's input to a more logical order.  You should edit the sub-files like yourname_weapons.txt, etc.  Then, ReadWrite will recombine them using the file list in yourname.txt.  Note that you can edit this file if you want to reuse an old monster file, for instance.

Version 2.1b changes -- fixed bug with longer names (weapons, armor, etc); cleared out a lot of legacy code that was not used; reduced diagnostic print-to-screens and made screen output much more useful to a user -- if the program crashes, you will be able to tell me what the last successfully ran module was.

Version 2.1 changes -- can now edit descriptive text of Weapons, Armor, Items (not key items) and Spells.  Monster name editing now supported.  All name editing upgraded to allow you to change the length of any name to any value than the max FF uses by default.  Note that the first character of Weapon/Armor/Item/Spell names denote the type that they are, and that makes a difference for Armor.

**Note -- any text files generated from this version are no longer backwards compatible.  Let me know if you need an older version of the editor!**

Version 2.0 changes -- can now edit "Regions", specifically what battle records occur in them.  Fixed a missing regular monster from DoS.

Version 1.9 changes -- can now edit "Battle Records" -- what sets of monsters are drawn from for each encounter.

Version 1.8 changes -- added leading zeroes to all binary inputs

Version 1.7 changes -- can now edit treasure chest contents, to include changing between gold and items/weapon/armor.  In theory you can change key item locations as well (type 0) -- not tested and of course very easy to break progress in the game.  Credit to Kea on GameFAQs for her invaluable information in finding this data as well as allowing use of her chest description locations.

Version 1.6 changes -- added 14 "spells" that control select items' behavior during battle, to include Potion/Hi-Potion/X-Potion, Ether/Turbo Ether/Dry Ether, Elixir/MegaElixir, Remedy, and the 5 "drinks" of Giant's Tonic, Fairie's Tonic, Strength/Protect/Speed Drinks.

Version 1.5 changes -- corrected AI byte for enemies -- edit the enemy AI byte in their listing, and it will change to the AI pattern described in... the new editable table at the bottom.  Please see Jeff Ludwig's webpage at http://jeffludwig.com/finalfantasy/hacking/enemy-ai for an explanation of the table.

Version 1.4 changes -- fixed erronous writing of monster spell data (was overwriting part of FFII) and fixed numbering of monsters post-Scarmilionge.
Known bugs: AI bit does nothing for monsters; AI behavior is hardcoded elsewhere, and I hope to include in a future version.

Known issues:
Character role names are not editable in the stock ROM yet.
Spell name editing is wonky - it works in stock, but not in the mod yet.
Editing any name (role, item, weapon, etc) -- keep the same string length please.  That means you can make same length or shorter (pad with spaces for the latter).


Note that this work is completely derivative of the work of the makers of FFI, and Jeff Ludwig's (jeffludgwig.com) hacking notes.  I own none of this.  I'm just sharing a set of files I use to manipulate my only properly-owned ROMs.

How to use the editor:
Make a backup of your ROM before you start.

Run DataPull1_6.exe, and have it open the ROM you want to pull data from.  You'll be asked if the ROM is the stock US version (0) or Jeff Ludwig's latest mod (3.5 at this time, enter 3).

The program will then generate a text file (pick the name you'd like to save it as.)

Open the text file in the editor of your choice, and edit the data.  Be careful not to add extra spaces or delete commas.  Exception: if you change the length of a name (character, spell name, monster), please pad it out with extra spaces.  Do not lengthen names, only shorten them.  I hope to improve on this in a future version.

When done, *save your text file*.  Then run ReadWrite1_6.exe.  Select the text file you just edited, then your ROM.  It will write the changes to the ROM.

Open your ROM in your emulator and/or GBA, and enjoy!  Most changes can be done without breaking saves, but I haven't tested this thoroughly.

Please send me any feedback to exline@gmail.com.  Please include "FF editor" in the subject so it doesn't get lost in the junk mail!

--Pete
